home *** CD-ROM | disk | FTP | other *** search
/ ETO Development Tools 2 / ETO Development Tools 2.iso / Essentials / Developer Essentials Nov 90 / Apple II / Apple.II.partition / Tools / Technical.Notes / IIGS / TN.IIGS.072 < prev    next >
Encoding:
Text File  |  1990-09-21  |  3.0 KB  |  76 lines  |  [TEXT/pdos]
  1. Apple II
  2. Technical Notes
  3. _____________________________________________________________________________
  4.                                                   Developer Technical Support
  5.  
  6. Apple IIgs
  7. #72:    QuickDraw II Quirks
  8.  
  9. Revised by:    Dave Lyons                                      September 1990
  10. Written by:    Dave Lyons                                       November 1989
  11.  
  12. This Technical Note points out some things things you need to watch out for 
  13. when using QuickDraw II, especially with FastPort-aware and Shadowing modes.
  14. Changes since November 1989:  Updated to reflect several QuickDraw II changes 
  15. in System Software 5.0.3; added warning about calling ShowPen with a polygon, 
  16. region, or picture open.
  17. _____________________________________________________________________________
  18.  
  19.  
  20. Shadowing
  21.  
  22. Bit 15 of the MasterSCB parameter to QDStartUp requests that QuickDraw II use 
  23. the memory at $012000 to shadow onto the real screen memory at $E12000.  (This 
  24. speeds up QuickDraw II, since memory in bank $01 can be read at full speed.)
  25.  
  26. Previously, QDShutDown on ROM 01 machines was not not disposing of the $012000 
  27. memory block if it was allocated by QDStartUp.  In 5.0.3, it's fixed--your 
  28. application does not need to worry about disposing of the shadow memory 
  29. manually.
  30.  
  31. Also, when QDStartUp uses shadowing on ROM 01 it does not actually clear the 
  32. bank one memory to black--the screen looks black, but when you start to draw 
  33. you get weird garbage around the stuff you draw (this is true in 5.0.3 and 
  34. earlier).  If you call RefreshDesktop before doing other drawing, it is not a 
  35. problem.  If you need to force the screen to clear, you can call 
  36. ClearScreen(0) right after QDStartUp.
  37.  
  38.  
  39. FastPort-Aware Anomaly
  40.  
  41. When the FastPort-aware bit is turned on in the MasterSCB parameter to 
  42. QDStartUp, DrawPicture does not notice changes in the pen pattern.  If your 
  43. application uses pictures, either directly or indirectly (i.e., by printing to 
  44. the ImageWriter driver), you may need to leave FastPort-aware mode turned off 
  45. to get the expected behavior.
  46.  
  47.  
  48. FastFont and Large Pixel Maps
  49.  
  50. FastFont does not work correctly when drawing past the first 64K of a pixel 
  51. map.  If you are drawing text that uses FastFont (i.e., Shaston 8), you can 
  52. avoid this problem by using a non-rectangular clipRgn.
  53.  
  54.  
  55. ScrollRect Fixed in 5.0.3
  56.  
  57. ScrollRect no longer hangs when scrolling with a small positive dY and a non-
  58. rectangular visRgn.
  59.  
  60.  
  61. Don't ShowPen While Collecting Polygons, Regions, or Pictures
  62.  
  63. The Macintosh QuickDraw documentation permits calling ShowPen after an 
  64. OpenPoly, OpenRgn, or OpenPicture call to cause drawing calls to contribute to 
  65. a polygon, region, or picture and draw to a pixel map at the same time.
  66.  
  67. The Apple IIgs QuickDraw II documentation does not say you can do that.  In 
  68. some cases, it works, but it works "by accident" and it's not one of the 
  69. things Apple tests or guarantees in QuickDraw II.
  70.  
  71.  
  72. Further Reference
  73. _____________________________________________________________________________
  74.   o  Apple IIgs Toolbox Reference, Volumes 1 and 3
  75.  
  76.